Java使用JavaMail收发Email电子邮件 |
您所在的位置：网站首页 › 邮件服务器开源 谷歌 › Java使用JavaMail收发Email电子邮件 |
Java使用JavaMail收发Email电子邮件
|
这是我参与8月更文挑战的第10天，活动详情查看：8月更文挑战 使用JavaMail收发送电子邮件，包括带有附件和内嵌图片的邮件！ Email就是电子邮件。发邮件是从客户端把邮件发送到邮件服务器，收邮件是把邮件服务器的邮件下载到客户端，Java同样提供了收发邮件的API。 163、126、QQ、sohu、sina等网站都提供了邮件服务，这些网站都有自己的邮件服务器，我们自己的Email用户页面实际上就相当于客户端。 1 邮件协议 1.1 邮件协议与HTTP协议相同，收发邮件也是需要有传输协议的： SMTP：（Simple Mail Transfer Protocol，简单邮件传输协议）发邮件协议； POP3：（Post Office Protocol Version 3，邮局协议第3版）收邮件协议； IMAP：（Internet Message Access Protocol，因特网消息访问协议）收发邮件协议。这些协议都属于应用层协议。 1.2 理解电子邮件收发过程其实你可以把邮件服务器理解为邮局！如果你需要给朋友寄一封信，那么你需要把信放到邮筒中，这样你的信会“自动”到达邮局，邮局会把信邮到另一个省市的邮局中。然后这封信会被送到收信人的邮箱中。最终收信人需要自己经常查看邮箱是否有新的信件。 其实每个邮件服务器都由SMTP服务器和POP3服务器构成，其中SMTP服务器负责发邮件的请求，而POP3负责收邮件的请求。 当然，有时我们也会使用163的账号，向126的账号发送邮件。这时邮件是发送到126的邮件服务器，而对于163的邮件服务器是不会存储这封邮件的。 smtp服务器的端口号为25，服务器名称为smtp.xxx.xxx。 pop3服务器的端口号为110，服务器名称为pop3.xxx.xxx。 例如： 163： smtp.163.com和pop3.163.com； 126： smtp.126.com和pop3.126.com； qq： smtp.qq.com和pop3.qq.com； sohu： smtp.sohu.com和pop3.sohu.com； sina： smtp.sina.com和pop3.sina.com。 2 JavaMail 2.1 JavaMail概述JavaMail是由SUN公司提供的专门用于Java收发邮件的API，使用Java程序发送邮件时，我们无需关心SMTP协议的底层原理，只需要使用JavaMail这个标准API就可以直接发送邮件。 JavaMail中主要类有javax.mail.Session、javax.mail.internet.MimeMessage、javax.mail.Transport。 Session： 表示会话，即客户端与邮件服务器之间的会话！想获得会话需要给出账户和密码，当然还要给出服务器名称。在邮件服务中的Session对象，就相当于连接数据库时的Connection对象。 MimeMessage： 表示邮件类，它是Message的子类。它包含邮件的主题（标题）、内容，收件人地址、发件人地址，还可以设置抄送和暗送，甚至还可以设置附件。 Transport： 用来发送邮件。它是发送器！ 2.2 maven依赖使用JavaMail的API我们需要引入对应的jar包或者maven依赖： com.sun.mail javax.mail 1.6.2jar包下载地址为：mvnrepository.com/artifact/co… 我们使用smtp协议发送邮件！ 2.3.1 简单邮件发送一个简单的邮件需要三步: 根据服务器参数和认证器信息来获取Session实例； 根据Session创建MimeMessage对象，MimeMessage中包含了各种可以设置的邮件属性 通过Transport发送邮件简单的案例如下： /** * @author lx */ public class SimpleSendEmail { public static void main(String[] args) throws MessagingException { /* * 1 获取Session */ /*设置服务器参数*/ Properties props = new Properties(); //设置服务器主机名 props.put("mail.smtp.host", "smtp.163.com"); //设置需要认证 props.put("mail.smtp.auth", "true"); // 启用TLS加密 props.put("mail.smtp.starttls.enable", "true"); /* * 根据服务器参数集合和认证器来获取Session实例 * * Authenticator是一个接口表示认证器，即校验客户端的身份。 * 我们需要自己来实现这个接口，实现这个接口需要使用账户和密码。 */ Session session = Session.getInstance(props, new Authenticator() { @Override protected PasswordAuthentication getPasswordAuthentication() { //使用自己的账户和密码，有些邮件服务器可能需要的是申请的授权码 return new PasswordAuthentication("[email protected]", "xxxx"); } }); // 设置debug模式，将会输出日志信息 session.setDebug(true); /* * 2 根据Session创建MimeMessage对象 * * MimeMessage中包含了各种可以设置的邮件属性 */ MimeMessage msg = new MimeMessage(session); //设置发信人 msg.setFrom(new InternetAddress("[email protected]")); //设置收信人，可以设置多个，采用参数数组或者","分隔 msg.addRecipients(TO, "[email protected]"); //设置抄送人，可以设置多个，采用参数数组或者","分隔 msg.addRecipients(CC, "[email protected]"); //设置暗送人，可以设置多个，采用参数数组或者","分隔 msg.addRecipients(BCC, "[email protected]"); //设置邮件主题（标题） msg.setSubject("第一封邮件"); //设置邮件内容（正文）和类型 msg.setContent("说点啥呢？", "text/plain;charset=utf-8"); /* * 3 发送邮件 */ Transport.send(msg); } } 2.3.2 发送HTML文本有时候我们的邮件正文可能是一个HTML页面，发送方式和上面的案例完全一致，只需要注意编码格式为“text/html;charset=utf-8”，后面的字符集要与html文本的字符集一致。 当然，也可以发送图片资源等等。 /** * @author lx */ public class SendHtmlEmail { public static void main(String[] args) throws MessagingException { /* * 1 获取Session */ /*设置服务器参数*/ Properties props = new Properties(); //设置服务器主机名 props.put("mail.smtp.host", "smtp.163.com"); //设置需要认证 props.put("mail.smtp.auth", "true"); // 启用TLS加密 props.put("mail.smtp.starttls.enable", "true"); /* * 根据服务器参数集合和认证器来获取Session实例 * * Authenticator是一个接口表示认证器，即校验客户端的身份。 * 我们需要自己来实现这个接口，实现这个接口需要使用账户和密码。 */ Session session = Session.getInstance(props, new Authenticator() { @Override protected PasswordAuthentication getPasswordAuthentication() { //使用自己的账户和密码，有些邮件服务器可能需要的是授权码 return new PasswordAuthentication("[email protected]", "xxx"); } }); // 设置debug模式，将会输出日志信息 session.setDebug(true); /* * 2 根据Session创建MimeMessage对象 * * MimeMessage中包含了各种可以设置的邮件属性 */ MimeMessage msg = new MimeMessage(session); //设置发信人 msg.setFrom(new InternetAddress("[email protected]")); //设置收信人，可以设置多个，采用参数数组或者","分隔 msg.addRecipients(TO, "[email protected]"); //设置抄送人，可以设置多个，采用参数数组或者","分隔 msg.addRecipients(CC, "[email protected]"); //设置暗送人，可以设置多个，采用参数数组或者","分隔 msg.addRecipients(BCC, "[email protected]"); //设置邮件主题（标题） msg.setSubject("HTML邮件"); //设置邮件内容（正文）和类型 msg.setContent("2021加油哦!", "text/html;charset =utf-8"); /* * 3 发送邮件 */ Transport.send(msg); } }结果： 如果想发送带有附件邮件，那么需要设置邮件的内容为MimeMultiPart，而不仅仅是一段文本。 多部件对象MimeMultiPart，可以理解为是部件的集合。一个Multipart对象可以添加若干个BodyPart，其中第一个BodyPart是文本，即邮件正文，后面的BodyPart是附件，最后将MimeMultiPart设置到msg的content中。 案例如下： /** * @author lx */ public class SendMultipartEmail { public static void main(String[] args) throws MessagingException, IOException { /* * 1 获取Session */ /*设置服务器参数*/ Properties props = new Properties(); //设置服务器主机名 props.put("mail.smtp.host", "smtp.163.com"); //设置需要认证 props.put("mail.smtp.auth", "true"); // 启用TLS加密 props.put("mail.smtp.starttls.enable", "true"); /* * 根据服务器参数集合和认证器来获取Session实例 * * Authenticator是一个接口表示认证器，即校验客户端的身份。 * 我们需要自己来实现这个接口，实现这个接口需要使用账户和密码。 */ Session session = Session.getInstance(props, new Authenticator() { @Override protected PasswordAuthentication getPasswordAuthentication() { //使用自己的账户和密码，有些邮件服务器可能需要的是申请的授权码 return new PasswordAuthentication("[email protected]", "ccc"); } }); // 设置debug模式，将会输出日志信息 session.setDebug(true); /* * 2 根据Session创建MimeMessage对象 * * MimeMessage中包含了各种可以设置的邮件属性 */ MimeMessage msg = new MimeMessage(session); //设置发信人 msg.setFrom(new InternetAddress("[email protected]")); //设置收信人，可以设置多个，采用参数数组或者","分隔 msg.addRecipients(TO, "[email protected]"); //设置抄送人，可以设置多个，采用参数数组或者","分隔 msg.addRecipients(CC, "[email protected]"); //设置暗送人，可以设置多个，采用参数数组或者","分隔 msg.addRecipients(BCC, "[email protected]"); //设置邮件主题（标题） msg.setSubject("附件"); //设置邮件内容（正文）和类型 //msg.setContent("2021加油哦!", "text/html;charset =utf-8"); /* * 创建一个多部件对象Multipart，可以理解为是部件的集合。 * 一个Multipart对象可以添加若干个BodyPart，其中第一个BodyPart是文本，即邮件正文，后面的BodyPart是附件 */ Multipart parts = new MimeMultipart(); /* * 设置邮件的内容为多部件内容。 */ msg.setContent(parts); /* * 创建第一个部件，为邮件正文 */ BodyPart contentPart = new MimeBodyPart(); //给部件设置正文内容 contentPart.setContent("附件来了!", "text/html;charset=utf-8"); //把部件添加到部件集中 parts.addBodyPart(contentPart); /* * 创建第二个附件部件，一张图片 */ MimeBodyPart imagepart = new MimeBodyPart(); //设置附件名称 imagepart.setFileName("people.jpg"); //注意，如果在设置文件名称时，文件名称中包含了中文的话，那么需要使用MimeUitlity类来给中文编码： //imagepart.setFileName(MimeUtility.encodeText("中文.jpg")); //设置附件，二进制文件可以用application/octet-stream，Word文档则是application/msword。 FileInputStream fileInputStream = new FileInputStream("email\\src\\main\\resources\\people.jpg"); imagepart.setDataHandler(new DataHandler(new ByteArrayDataSource(fileInputStream, "application/octet-stream"))); //把附件添加到部件集中 parts.addBodyPart(imagepart); /* * 3 发送邮件 */ Transport.send(msg); } }结果： 发送的HTML文本的内嵌图片可以采用网络链接，也可以使用本地图片。本地内嵌图片实际上也是一个附件，即邮件本身也是Multipart，但需要做一点额外的处理。 在HTML邮件中引用图片时，需要设定一个ID，用类似 我们使用pop3协议收取邮件！ public class ReceiveEmail { public static void main(String[] args) throws MessagingException { //POP3主机名 String host = "pop3.163.com"; //设置传输协议 String protocol = "pop3"; //用户账号 String username = "[email protected]"; //密码或者授权码 String password = "NPYRDKGYNSZIRZYO"; /* * 获取Session */ Properties props = new Properties(); //协议 props.setProperty("mail.store.protocol", protocol); //POP3主机名 props.setProperty("mail.pop3.host", host); props.setProperty("mail.smtp.auth", "true"); Session session = Session.getInstance(props); session.setDebug(true); /* * 获取Store，一个Store对象表示整个邮箱的存储 * */ URLName urlName = new URLName(protocol, host, 110, null, username, password); Store store = session.getStore(urlName); //连接邮件服务器 store.connect(); //要收取邮件，我们需要通过Store访问指定的Folder（文件夹），通常是INBOX表示收件箱 //获取邮箱的邮件夹，通过pop3协议获取某个邮件夹的名称只能为inbox，不区分大小写 Folder folder = store.getFolder("INBOX"); //打开邮箱方式（邮件访问权限），这里的只读权限 folder.open(Folder.READ_ONLY); //打印邮件总数/新邮件数量/未读数量/已删除数量: System.out.println("Total messages: " + folder.getMessageCount()); System.out.println("New messages: " + folder.getNewMessageCount()); System.out.println("Unread messages: " + folder.getUnreadMessageCount()); System.out.println("Deleted messages: " + folder.getDeletedMessageCount()); // 获得邮件夹Folder内的所有邮件Message对象，一个Message代表一个邮件 Message[] messages = folder.getMessages(); for (Message message : messages) { /*解析邮件*/ //获取主题 String subject = message.getSubject(); System.out.println(subject); //解析其他内容 //……………… } //传入true表示删除操作会同步到服务器上（即删除服务器收件箱的邮件），无参方法默认传递true folder.close(); store.close(); } } 2.5 相关异常 Exception in thread "main" com.sun.mail.smtp.SMTPSendFailedException: 554 DT:SPM 一般是被邮件服务器识别为垃圾邮件，可以换个复杂点的主题和内容，或者换台主机发送。这很麻烦，比如在运行上面的案例时就有可能抛出这样的异常！ Exception in thread "main" javax.mail.AuthenticationFailedException: 535 Error: authentication failed PasswordAuthentication中的用户登陆信息错误，可能是密码或者授权码错误。 Exception in thread "main" com.sun.mail.smtp.SMTPSendFailedException: 553 Mail from must equal authorized user 如果用户信息和发件人信息不一致 3 总结本次我们学习了使用JavaMail的API简单的收发邮件的过程，电子邮件的收发需要使用道SMTP和POP3协议。在实际开发中，这样的底层API我们用的比较少，因为代码编写很麻烦，因此本文了解就行了。 在实际项目开发中，常常使用Spring框架为我们提供的更高级的发送邮件的API。 如有需要交流，或者文章有误，请直接留言。另外希望点赞、收藏、关注，我将不间断更新各种Java学习博客！ |
【本文地址】
今日新闻 |
推荐新闻 |